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The Truth About Free 
System Resources 



re there certain Windows ap- 
plications that you just can't 
live without? If there are, 
you probably set up your sys- 
tem so that it would run Win- 
dows well. You probably 
upgraded the RAM in your 
PC and configured a swap 
file on your hard disk in or- 
der to take advantage of virtual memory. 
' Then, after loading three or four applica- 
tions, you discovered that Windows 
( wouldn't let you load any more pro- 
| grams. Program Manager says that there 
• are still several megabytes of RAM avail- 
: , able, but to load another program, you 
have to close one of the active ones first. 
What's going on here? You just 
.rned the hard way that available RAM 
isn't the only factor that limits the num- 
ber of programs you can load concur- 
rently in Windows. A more unavoidable 
traint is the amount of free system 
urces. In simple terms, system re- 
tirees refers to a limited area of mem- 
iry that Windows sets aside internally to 
store data about windows and objects 
;1 created by Windows programs, and free 
system resources (FSR) is the percentage 
of this memory that isn't being used. 
You can find out what your FSR per- 
icentage is from Program Manager's 
About box. Loading a large application 
such as Word for Windows or Excel gen- 
erally uses up 5 to 10 percent of your FSR 
Windows 3.1, and often more in Win- 
ws 3.0. No matter how much RAM 
. our PC contains, Windows will refuse to 
load more programs when FSR 
approaches zero. Furthermore, it's wise 
a never to let the FSR percentage drop too 
low. All sorts of strange things may hap- 
pen when FSR goes below 10 or 15 per- 
| cent, ranging from the benign — for exam- 
icons losing their titles — to full- 
hedged system crashes. 
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FSR is something every Windows user 
should be aware of, but it is one of the 
aspects of Windows that isn't widely un- 
derstood. In this installment of Tutor, 
you'll learn about system resources, how 
Windows handles them, and how that 
handling differs in 3.0 and 3.1. You'll also 
acquire a useful new utility for keeping 
tabs on FSR, complete with source code. 

FREE SYSTEM RESOURCES DEFINED Win- 
dows relies extensively on data struc- 
tures — collections of variables that are 
grouped together because they serve a re- 
lated purpose. Many of these structures 
are not static, but are created and de- 
stroyed on-the-fly as circumstances re- 
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quire. For example, when you open a 
window, Windows creates a data struc- 
ture in memory that belongs to Windows, 
and that data structure contains impor- 
tant information such as who the win- 
dow's owner is, the window's size, and its 
position on the screen. Many windows 
contain other windows (controls such as 
buttons and list boxes are actually win- 
dows), so a single application program 
frequently begets several window data 
structures. 

The window data structure is only one 
example of the many data structures that 
Windows uses internally. Many of these 
internal data structures were never in- 



tended to be accessed directly and are 
therefore not documented. We only 
know about them through inference and 
through texts like Undocumented Win- 
dows by Andrew Schulman and others 
(1992, Addison-Wesley). Other items 
stored this way include menus, window 
classes, device contexts, and GDI 
(Graphics Device Interface) objects such 
as brushes, pens, bitmaps, and fonts. 
Each data structure that Windows cre- 
ates consumes a small amount of mem- 
ory. Free system resources is the percent- 
age of memory that Windows sets aside 
to hold internal data structures that are 
currently unused. 

Where does Windows find room to 
store the data structures? In the local 
heaps of two of the program modules (ac- 
tually DLLs) that make up Windows — 
GDI.EXE and USER.EXE. In Win- 
dows, every program is assigned at least 
one data segment whose length is 64K or 
less. Part of the data segment is used to 
store variables created by the program, 
and part of it is used to hold the pro- 
gram's stack. The remainder of the seg- 
ment — the free memory — constitutes the 
program's local heap. If desired, a pro- 
gram may allocate memory from its local 
heap by calling a Windows API function 
called LocalAUoc. GDI and USER con- 
tain their own local heaps, and it is inside 
these heaps that Windows stores the 
aforementioned data structures. These 
heaps are the system resources in free sys- 
tem resources. 

To understand the mechanism by 
which system resources are consumed, 
consider what happens when a program 
creates a GDI brush. First GDI calls Lo- 
calAUoc to acquire enough heap space to 
hold a brush data structure. Then it ini- 
tializes the data structure and passes the 
address back to the program that created 
the brush to use as a handle — a number 
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that uniquely identifies the brush. The 
^e space in GDI's heap diminishes by 
,.ie number of bytes required for the 
brush data structure. Given that there 
may be dozens (more likely, hundreds) 
of GDI objects defined in the system at 
any time, and that every one of them con- 
sumes space in GDI's heap, it's easy to 
imagine how the heap could fill up very 
quickly. 

In Windows 3.0, USER contained two 
local heaps and GDI contained one. One 
USER heap stored data structures for 
windows, menus, window classes, and 
other USER objects; the other stored 
Window's global atom table (a system- 
wide "dictionary" to which programs can 
add and delete text strings). The GDI 
heap stored all data structures related to 



Windows' Graphics Device Interface. By 
analyzing Windows 3.0 running real- 
world application programs, Microsoft 
determined that menus were causing the 
greatest strain on FSR, so in Version 3.1 
they added two more heaps to USER— 
one to hold menu data structures and one 
to hold menu strings. GDI also gained an 
extra local heap in 3.1. 

Earlier, we defined free system re- 
sources as the amount of memory re- 
maining for Windows to store internal 
data structures. We can now refine this 
definition to say that in Windows 3.0, 
FSR is the percentage of free space re- 
maining in the primary USER heap or 
the percentage of free space remaining 
in the GDI heap, whichever is less. In 3.0, 
USER typically ran out of heap space 



long before GDI, so GDI rarely factored 
into FSR. It is not entirely clear how Win- 
dows 3.1 computes FSR. It probably di- 
vides total free space in the USER heaps 
by the combined length of the USER 
heaps, does the same for GDI, and re- 
ports the lesser of the two. It also appears 
that Program Manager doesn't use the 
GetFreeSystemResources API function, 
which debuted in Windows 3.1, because 
the percentage reported by the function 
and the one reported by Program Man- 
ager occasionally disagree by a percent. 

The good news to users is that because 
of the increased heap space in USER and 
GDI, Windows 3.1 is less susceptible to 
FSR shortages than 3.0. But limited FSR 
is still a problem, and it is likely to con- 
tinue to be until we move to a 32-bit oper- 
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FSR displays the percentage of free system resources in real time. 
Copyright (cj 1993 Jeff -Prosise. First published in PC Magazine. 
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tinclude <windows . h> 
tinclude <stdlib.h> 

♦define WARN I NG L EVEL 20 
•define I DM_ALWA YSONTO P 100 

axtern DWORD FAR PASCAL GetHeapSpaces (HMODULE) ; 
long FAR PASCAL WndProc (HWND, WORD, WORD, LONG) ; 
DWORD GetFSR (BOOL) ; 

WORD wTimerlD; 



WinMain starts the program. 



int PASCAL WinMain (HANDLE hlnstance, HANDLE hPrevlnstance, 
LPSTR lpszCmdLine, int nCmdShow) 



"Free System Resources" ,- 



static char szAppName (] 
WNDCLASS wndclass; 
HWND hwnd; 
MSG msg; 

if _ (hPrevlnstance) 
' - ■ - re turn FALSE ; 

wndclass. style = CS_HREDRAW ! CS_VREDRAW; 
wndclass. lpfnWndProc = (WNDPROC) WndProc 
wndclass. cbClsExtra = 0; 
. wndclass . cbWndExtra = ; . 
wndclass .hlnstance = hlnstance; 
wndclass .hlcon = NULL; 
wndclass .hCursor t LoadCursor (NULL, 
wndclass .hbrBackground f GetStockObj 
wndclass . IpszMenuName = NULL; 
wndclass. IpszClassName ■ szAppName; 



IDC_ARROW) ; 
Ct (LTGRAY_BRUSH) ; 



RegisterClass (iwndclass) ; 

hwnd = CxeateWindow (szAppName, szAppName, WS_OVERLAP P EDWINDOW , 

CW_U S EDEFAULT , CW_USEDEFAULT, 384, 96, NULL, NULL, 
hlnstance, NULL) ; 

if ( (wTimerlD ■'■ SetTimer (hwnd,"". 1. 1000, NULL) ) ==__ NULL) { 
MessageBox (hwnd, "Unable to allocate a timer", "Error", 

MB_ I CONEXC LAMAT I ON | MB_OK) ; 
return FALSE; 
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Showwindow (hwnd, nCmdShow) ; 
Updatewindow [hwnd) ; 



while (GecMessage (amsg. NOLL. 8, B)J 



return msg.wParam; 



WndProc processes messages to the main window. 



long FAR PASCAL WndProc (HWND hwnd, WORD message, WORD 

*c n ■ 'j_ ; . + ■ ... ^L; , \ . „ . t, ' 

Static char szSect ion [] * "Options" ; 
static char szEntryE] =" 'AlwaysOnTop" ; 
static char szlniFile[] = ■ FSR . INI ■ ; 

static HP EN hGrayPen; 
static HBRUSH hPinkBrush, hRedBrush; 
static DWORD dwPercentFree , dwOldPercent; 
RECT rect, rectUsed, rectPree; 
DWORD dwVersion, dwTotal; 
static BOOL bWinJIFlag; 
' Static HMENU hSysMenu; 
Char szBuf fer (4 1 ; 
PAINT STRUCT ps ; 
, ' ■ HDC hdc; . 1 ' '" yj-i j, 

switch (message) ( 

.. case WM_CREATE : 

dwVersion = GetVersion (); 

if ( (LOBYTE (LOWORD (dwVersion)) >= 3) &&. 
(HIBYTE (LOWORD (dwVersion) ) >= 10)) 
„ fc*fin31Flag = TRUE; 

else >' -i-' „ ■ - j ■" 

bWin31Flag = FALSE; 

hGrayPen = CreatePen (PS_SOLID, 1, RGB (128, 128, 128)); 
hPinkBrush = CreateSolidBrush (RGB (192, t, 192)); 
hRedBrush = CreateSolidBrush (RGB (192, 0, 0)): 



wParam, LONG lParam) 



M31 



dwPercentFree 
dwOldPercent = 



i GetFSR (bWin31Flag) ; 
dwPercentFree; 



if (bWin31Flag) ( 

hSysMenu = GetSystemMenu (hwnd, FALSE) j ; 
AppendMenu (hSysMenu, MF_SEPARATOR, 0, NULL) ; 
AppendMenu (hSysMenu, MF_STRING, IDM_ALWAYSONTOP , 

"Always on tTop*) ' r *"! 
if (GetPrivateProf ilelnt (szSection. szEntry, 0, szIniPila) ) 
' CheckMenuItem (hSysMenu, IDM_ALWAYSONT0P , MF_CHECKED) ;. 
SetWindowPos (hwnd, HWND_TOPMOST, 0, 0, 0. 0, 
SWP_NOMOVE [ SWP_NOSIZE) ; , 



return ; 



G1 .• : 



case WM_PAINT; 

hdc = BeginPaint (hwnd, lips); 
SetBkMode (hdc, TRANSPARENT) ; 
GetClientRect (hwnd, &rect) ; 



• 'Jit 
"?-T 



if (Islconic (hwnd) ) { . 

if (dwPercentFree >= WARNING LEVEL) ( 

PillRect [hdc, srect, GetStockObject ( LTORAY_BROSH I ) f 
SetTextColor (hdc, RGB («, fl, 192)); 

- ) • 



i 



Figure 1: The source code for FSR. EXE, a Windows utility that tracks free system resources in real time. 
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else ( I'-f C.'-fV-'- '• • ' " 

FillRect [hdc, fcrect, hRedBrush) ; 
SetTextColor (hdc, RGB (255, 255, 255)); 



DrawText (hdc, _itoa ( (int) dwPercentFree , 
-1, fcrect, DT_SINGLELINE ! DT_CENTER | 



szBuf fer; 10) , 
DT_V CENTER) ; 



else if ( (--rect. bottom < 16) || (— rect. right < 32) ) 

FillRect (hdc, &rect, GetS toe JcObject ( LTGRAY__BRUSH) ) ; 

elee 1 : - d$£&--> 

InflateRect (&rect, -4, -4) ,- , - ' 

SelectObject (hdc, hGrayPen) ; 

MoveTo (hdc, rect. left, rect .bottom) ,- 

LineTo (hdc, rect: left-,- rect. top),- 

LineTo (hdc, rect .rioht+1, rect. top) ; 

MoveTo (hdc, rect- right-l, rect. top+1) ,- 

LineTo (hdc, rect.left+1, rect . top+1) '• 

LineTo (hdc , rect . left+1, rect. bottom) ; 

SelectObject, (hdc, GetStockObject (WHITE_PEN) ) ; 

MoveTo (hdc, rect.left+1, rect. bottom) ; 

LineTo (hdc, rect. right, rect. bottom) ,v 

LineTo (hdc, rect. right, rect. top) ,- 

MoveTo (hdc, rect .right-1, _ rect. top+2); 

LineTo (hdc, rect.right-1, rect -bottom-l) ,- 

LineTo (hdc, rect.left+1, rect.bottom-1) ; 



InflateRect Urect, -2, 

rect.right++; 

rect .bottom++ ; 



CopyRect (irectUsed, Sr'ect) ; 



CopyRect l&rectFree, irect") 

dwTotal = {DWORD) (rect. right - rect.left); 
rectFree. right =■ rectFree.left + 

((int) ((dwTotal * dw DeleteObject (hRedBrush); 

DeleteObject (hGrayPen); ... . .- 
PostQuitMessage (0); 
' ; .-' " • .return 0; •'• -. 

. ) -- ■■■ ■■:f^;r l ■ . - . r . -}■'-■,■■ -. : - ; 

• return DefiWindowProc (hwnd. message, wParam, 1 Par am) ; 

/ . 

GetFSR returns a value- between and 100 that quantifies the 
percentage of free system resources. 

; " v ' 

DWORD GetFSR (BOOL bWin31) 
DWORD dwHeapSpaces;. 

WORD wUSERPercentFree, wGDIPercentFree ; 

if (bWin31) ■ ' --^y ' ' : - 'V- : V -' A -'-'. h ■ ' ■ "A ' "•- " 

return ( (DWORD) GetFreeSystemResources (GFSR_SYSTEMRESOURCES) ) ; 

y : "; ■„ else { ' ■' - : ; ■ ft'" Jf, 1 ;'"; : '" ■ " , ' :,,, ^^Y>'"". ■ »'-■-',, 

dwHeapSpaces = GetHeapSpaces (GetModuleHandle { "USER" ) ) ; 
wUSERPercentFree = (WORD) {((DWORD) (LOWORD (dwHeapSpaces)) * 100) / 

((DWORD) (HIWORD (dwHeapSpaces)))); 
dwHeapSpaces = GetHeapSpaces (GetModuleHandle ("GDI")); 
wGDIPercentFree = (WORD) ({(DWORD) (LOWORD (dwHeapSpaces)) * 100) / 

((DWORD) (HTWORD (dwHeapSpaces)))); 
return ( (DWORD) min (wUSERPercentFree, wGDIPercentFree) ) ; 

, - r/ - \ : • . ' 




ting system such as Windows NT or 
[IDS/2. In 16-bit Windows, increasing the 
eap space would mean creating more lo- 
cal heaps or moving internal data struc- 
es to the global heap. The former is 
esirable because it would make Win- 
y„*s as a whole more fragmented (that 
is, the data structures would be divided 
among more heaps) and still not solve the 
problem (if one local heap fills up, you 
may still run out of FSR even if the other 
jieaps are nearly empty). The latter 
\ jwould bog down performance because of 
Bie segment register manipulations re- 
quired. A 32-bit operating system makes 
file issue of local versus global heaps 
oot, because the 386 and 486 do not suf- 
fer from 64K segmentation limits. 
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•e 2: The horizontal bar presented by FSR.EXE graphically 



GAUGING FREE SYSTEM RESOURCES Fig- 
ure 1 lists the C source code for a Win- 
dows utility named FSR.EXE, which 
tracks free system resources in real time. 
When it is displayed as a window, FSR 
draws a horizontal bar that represents the 
percentage of free system resources, as 
shown in Figure 2. The bar scales to the 
size of the window, so you can make it 
as large or as small as you'd like. If free 
system resources fall below 20 percent, 
the bar changes from magenta to red as 
a warning. When it is reduced to an icon, 
FSR displays the percentage of free sys- 
tem resources in numeric form. The dis- 
play is updated once a second. With FSR 
running, you should never again have to 
open Program Manager just to check free 
system resources. 

The heart of FSR is the func- 
tion named GetFSR, which re- 
turns a DWORD (double 
word) value equal to the per- 
centage of system resources 
free. In Windows 3.1, GetFSR 
calls the documented Get- 
FreeSystemResources function 
to get a count of free system re- 
sources. In Windows 3.0, it calls 
the undocumented GetHeap- 
Spaces function, which accepts 
a module handle and returns a 
DWORD whose high word is 
equal to the number of bytes in 



the default local heap and whose low 
word is equal to the number of free bytes 
in the heap. GetFSR calls GetHeap- ^ 
Spaces once with the module handle of 
USER and once with the module handle 
of GDI, computes percent free in each 
module by dividing free bytes by total 
bytes and multiplying by 100, and then 
returns the lesser of the two percentages. 
GetHeapSpaces was discussed in PC 
Magazine's November 12, 1991, Win- 
dows column, and it is treated at length 
in Undocumented Windows. GetHeap- 
Spaces produces erroneous results in 
Windows 3.1, because it does not take 
into account the additional heaps set 
aside for USER and GDI. 

If you run it under Windows 3.1, FSR 
adds an "Always on Top" option to its 
system menu. When checked, "Always 
on Top" ensures that the FSR window 
stays visible even if another application 
is running full-screen. The program re- 
members how you last set it and automat- 
ically assumes the same configuration the 
next time you start it. You can download 
the FSR executable and related files from 
the Tutor section of the Utilities/Tips 
Forum on PC MagNet. FSR.EXE is the 
executable only; FSR.ZIP contains 
FSR.EXE, a document file, the source 
code, and the other files you need to com- 
pile FSR.EXE with Microsoft C 7.0 and 
Windows 3.1 's SDK. □ 
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